MGLOfflinePack | 您所在的位置:网站首页 › Static Maps API MapTiler Cloud › MGLOfflinePack |
MGLOfflinePack
@interface MGLOfflinePack : NSObject
An MGLOfflinePack represents a collection of resources necessary for viewing a region offline to a local database. To create an instance of MGLOfflinePack, use the +[MGLOfflineStorage addPackForRegion:withContext:completionHandler:] method. A pack created using -[MGLOfflinePack init] is immediately invalid. Example MGLOfflineStorage.shared.addPack(for: region, withContext: context) { (pack, error) in guard let pack = pack else { // If adding the pack fails, log an error to console. print("Error:", error?.localizedDescription ?? "unknown error adding pack at \(#file)(\(#line)) in \(#function)") return } // Start an MGLOfflinePack download pack.resume() } regionThe region for which the pack manages resources. DeclarationObjective-C @property (nonatomic, readonly) id _Nonnull region;Swift var region: MGLOfflineRegion { get } contextArbitrary data stored alongside the downloaded resources. The context typically holds application-specific information for identifying the pack, such as a user-selected name. To change the value of this property, use the -setContext:completionHandler: method. If you access this property after calling that method but before its completion handler is called, this property鈥檚 value may not reflect the new value that you specify. DeclarationObjective-C @property (nonatomic, readonly) NSData *_Nonnull context;Swift var context: Data { get } -setContext:completionHandler:Associates arbitrary contextual data with the offline pack, replacing any context that was previously associated with the offline pack. Setting the context is asynchronous. The context property may not be updated until the completion handler is called. DeclarationObjective-C - (void)setContext:(nonnull NSData *)context completionHandler:(void (^_Nullable)(NSError *_Nullable))completion;Swift func setContext(_ context: Data, completionHandler completion: ((Error?) -> Void)? = nil) Parameterscontext The new context to associate with the offline pack. completion The completion handler to call when the context has been updated. If there is an error setting the context, the error is passed into the completion handler. stateThe pack鈥檚 current state. The state of an inactive or completed pack is computed lazily and is set to MGLOfflinePackStateUnknown by default. To request the pack鈥檚 status, use the -requestProgress method. To get notified when the state becomes known and when it changes, observe KVO change notifications on this pack鈥檚 state key path. Alternatively, you can add an observer for MGLOfflinePackProgressChangedNotifications about this pack that come from the default notification center. DeclarationObjective-C @property (nonatomic, readonly) MGLOfflinePackState state;Swift var state: MGLOfflinePackState { get } progressThe pack鈥檚 current progress. The progress of an inactive or completed pack is computed lazily, and all its fields are set to 0 by default. To request the pack鈥檚 progress, use the -requestProgress method. To get notified when the progress becomes known and when it changes, observe KVO change notifications on this pack鈥檚 state key path. Alternatively, you can add an observer for MGLOfflinePackProgressChangedNotifications about this pack that come from the default notification center. DeclarationObjective-C @property (nonatomic, readonly) MGLOfflinePackProgress progress;Swift var progress: MGLOfflinePackProgress { get } -resumeResumes downloading if the pack is inactive. When a pack resumes after being suspended, it may begin by iterating over the already downloaded resources. As a result, the progress structure鈥檚 countOfResourcesCompleted field may revert to 0 before rapidly returning to the level of progress at the time the pack was suspended. To temporarily suspend downloading, call the -suspend method. DeclarationObjective-C - (void)resume;Swift func resume() -suspendTemporarily stops downloading if the pack is active. A pack suspends asynchronously, so some network requests may be sent after this method is called. Regardless, the progress property will not be updated until -resume is called. If the pack previously reached a higher level of progress before being suspended, it may wait to suspend until it returns to that level. To resume downloading, call the -resume method. DeclarationObjective-C - (void)suspend;Swift func suspend() -requestProgressRequest an asynchronous update to the pack鈥檚 state and progress properties. The state and progress of an inactive or completed pack are computed lazily. If you need the state or progress of a pack whose state property is currently set to MGLOfflinePackStateUnknown, observe KVO change notifications on this pack鈥檚 state key path, then call this method. Alternatively, you can add an observer for MGLOfflinePackProgressChangedNotification about this pack that come from the default notification center. DeclarationObjective-C - (void)requestProgress;Swift func requestProgress() |
CopyRight 2018-2019 实验室设备网 版权所有 |